HPAVC

home *** CD-ROM | disk | FTP | other *** search

/ HPAVC / HPAVC CD-ROM.iso / pc / DMPC196.ZIP / DMPC.DOC < prev next >

Wrap

Text File | 1994-02-11 | 14.1 KB | 321 lines

╔╤╤╤╤╤╤╤╤╤══════════════════════════════════════════════════════════╤╤╤╤╤╤╤╤╤╗ ╟┼┼┼┼┼┴┴┴┘░░░░▒▒▒▒▓▓▓▓██████████████████████████████████▓▓▓▓▒▒▒▒░░░░└┴┴┴┼┼┼┼┼╢ ╟┴┴┴┴┘░░░░▒▒▒▒▓▓▓▓████┌────────────────────────────────┐████▓▓▓▓▒▒▒▒░░░░└┴┴┴┴╢ ║░░░░▒▒▒▒▓▓▓▓████ ·∙──┤ Dual Module Player Companion ├──∙· ████▓▓▓▓▒▒▒▒░░░░║ ╟┬┬┬┬┐░░░░▒▒▒▒▓▓▓▓████└────────────────────────────────┘████▓▓▓▓▒▒▒▒░░░░┌┬┬┬┬╢ ╟┼┼┼┼┼┬┬┬┐░░░░▒▒▒▒▓▓▓▓██████████████████████████████████▓▓▓▓▒▒▒▒░░░░┌┬┬┬┼┼┼┼┼╢ ╚╧╧╧╧╧╧╧╧╧═════════════════╤══════════════════════╤═════════════════╧╧╧╧╧╧╧╧╧╝ │ ⌐ Version 1.96 ¬ │ ┌──┴──────────────────────┴──┐ │ (C) 1993 Psychic Psoftware │ └────────────────────────────┘ Introduction ■ ┌─────────────────────────────────────────────-─--∙∙··· · ─────────────────────┘ ■ This program is CARDWARE/SMILEWARE, that is, you may distribute it freely as long as you don't charge any fee for it and if you want to continue using it, please send me a postcard of your hometown (or a letter with a picture of your hometown included). ■ DMPC was written as a front end for the Dual Module Player ((C) 1992, 1993 Otto Chrons). DMPC was originally coded just before I had to write an examination, so don't expect miracles (not big ones anyway). It was designed to be small and fast rather than big and flashy, and with with the logo and swapper it's now small, fast and flashy! Hopefully this will make using the command-line driven DMP (An excellent product!) easier to use. ■ Legal stuff: If this program does anything that is antisocial to your computer, hey, shit happens.... and I'm not responsible. Features ■ ┌─────────────────────────────────────────────────-─--∙∙··· · ─────────────────┘ ■ Supports: MOD, STM, AMF, S3M, 669, MTM, ULT, FAR, NST, VOC, WAV and SND. ■ Reads the directory much faster than ModPlay v2.19b ((C) Mark Cox). ■ Reads up to 1000 music files in any directory. ■ Reads/plays music files from inside ARJ, LHA/LZH, ZIP, LIMIT and SQZ archives. ■ Mouse support. ■ Play a list of files sequentially or in random order. ■ You can use DMP or PMP (and almost any other player... but who would want to use anything but the best?) ■ Selection window accomodates 43/50 line mode. ■ Switch between 25 and 43/50 line modes. ■ Load/Save tagged selection. ■ Change drive/directory. ■ Fast file find with partial matching. ■ Help page. ■ Extract to temp directory. ■ Recognises Amiga style MOD.NAME format. ■ Delete files/all tagged files. ■ Multiple config definitions. ■ Shell to DOS. ■ Format inclusion masking. ■ Fast directory changing. ■ Command-line starting directory selection. ■ Sample preview & ripper for MOD, S3M, 669, MTM, ULT, FAR, STM & AMF files. ■ Rip sample to signed SMP, unsigned RAW, WAV and SND formats. ■ Preview sample through Soundblaster, DAC on LPT port or PC Speaker. ■ Tag/untag by file extension. Keys ■ ┌─────────────────────────────────────────────────────-─--∙∙··· · ─────────────┘ Up and down scroll through the list of music files. ENTER will play the file you are currently on OR changes the directory if you selected a directory. SPACE will tag/untag a file. T tags all. U untags all. D delete current file. P plays all tagged files in order or if there are no tagged files, it will act like ENTER. R does the same as P except that it specifies random selection. S Save current tagged selection to file. L Load a tag selection from file (clears previous tagged selection). . Re-read current directory. V Switch line mode (if possible). C Change drive. F Find a music file by name. H Display help page. 1..0 Select config 1-10 F10 Shell to DOS CTRL-C Change to directory on current drive. CTRL-D Delete all tagged files. CTRL-R Go into the sample ripper/previewer CTRL-T Tag all files with certain file extension. CTRL-U Untag all files with certain file extension. ■ To move faster up and down the list you can use PG UP/PG DN or HOME/END. P and R specify -l so that the mods don't loop. When your tagged selection includes archived files, DMPC will de-archive and play them one at a time (for disk space reasons) randomly or sequentially. If DMPC is controlling the selection play then pressing N in DMP will not take you to the next file in the selection (for obvious reasons) but if you press ESC it will play the next file. Press ESC twice in fast succession if you want to quit a DMPC controlled selection (and I mean fast!). ■ Pressing V will try to switch your screen from 25 to 43/50 line mode (if you are in 25 line mode) or from 43/50 to 25 line mode (if you are in 43/50 line mode). ■ If you have a mouse, moving the mouse up and down will do the same as the up and down arrow keys. The left button emulates P and the right button emulates SPACE. Sample Ripper ■ ┌────────────────────────────────────────────-─--∙∙··· · ──────────────────────┘ In the sample ripper you have a new set of functions mapped to the keys. You can use the cursor keys to move to the different samples. If you want to preview the samples, try and use a DAC or SoundBlaster, because the samples sound really lousy through the PC Speaker.... You can only preview up to 64k, therefore if a sample is bigger than 64k, you'll only hear up to the 64k mark. The ripper, however, can rip the samples even if they're bigger than 64k. MTM and ULT support doesn't include support for 16 bit samples. Config options: RIPPER_DIR is the directory where you want DMPC to save your samples to. RIPPER_DEVICE tells DMPC what device it will be using, valid options are SoundBlaster, DAC and PC Speaker. RIPPER_PORT is the port that DMPC will play the sample through, currently the routine works for DACs, the PC Speaker and SoundBlaster, if you can get it to play on some other card, please email me the info! RIPPER_DMA specifies what DMA channel to use for the SoundBlaster. P Play a sample. R Rip a sample to disk file in 8-bit signed format (.SMP). U Rip the sample in 8-bit unsigned format (.RAW). S Rip the sample in SoundTool format (.SND). W Rip the sample in Windows WAVE format (.WAV). V Rip the sample in Creative Voice format (.VOC). 1..8 Change tempo/frequency of playback. ESC Go back to DMPC menu. PLEASE NOTE: The ripper SUPPORTS MOD, S3M, 669, STM, MTM, ULT, AMF and FAR files (FAR might not work, it's still being tested, NST should work, but I can't verify that). Trying to rip unknown formats will produce garbage & maybe crash DMPC! I'm working on the other formats (what other formats are there now?), but don't hold your breath... I need format specs!! Please send me the specs for whatever formats you can get your hands on!! DMPC's SoundBlaster code doesn't work on PAS cards or GUS cards in emulation mode, sorry guys. >> Make sure your memory manager has a 64k DMA buffer set up, I'm << >> using a 64k buffer for SoundBlaster transfers and if the buffer is << >> too small, nasty things will happen! << Configuration ■ ┌────────────────────────────────────────────-─--∙∙··· · ──────────────────────┘ ■ DMPC has a config file (DMPC.CFG) for the command-line switches that you would use when loading DMP. The format of the config has changed (for the better) from that of the previous versions of DMPC. It now can have multiple devices and players and follows the MS Windows (TM) (yech!) INI type format. Many of the options are now defaulted for ease of use. See the example config below for an illustration of the new format. The device name can be up to 30 characters long, options 40 characters and the player definitions can be up to 60 characters long. The file inclusion mask is a list of characters that represent the different formats that a player can play. M = MOD S = STM N = NST 6 = 669 V = VOC W = WAV 3 = S3M D = SND A = AMF T = MTM F = FAR U = ULT Example config file (between the <--- ---> lines): <--- BEGINNING OF CONFIG FILE ---> ;TEMP directory, defaults to current. TEMP=C:\TEMP RIPPER_DEVICE=SoundBlaster RIPPER_PORT=$220 RIPPER_DMA=1 RIPPER_DIR=C:\SAMPLES START_PATH=C:\TEMP\MOD ;^^ The directory you would like DMPC to start up in. ZIP_PATH=C:\UTILS\ZIP.EXE ; ^^^^ Only needed for deleting files from ZIPs ARJ_PATH=C:\UTILS\ARJ.EXE LHA_PATH=C:\UTILS\LHA.EXE SQZ_PATH=C:\UTILS\SQZ.EXE UNZIP_PATH=C:\UTILS\UNZIP.EXE LIMIT_PATH=C:\UTILS\LIMIT.EXE ;SoundBlaster configuration [SoundBlaster] ;The %S is optional unless you need the music file name before or in the options ;eg. OPTIONS=/i /m:%S /s:22000 ;or something in that vein. OPTIONS=-p220 -i5 -d1 -q -8 -l -c1 %S ;MOD, STM, NST, 669, S3M, AMF, MTM, ULT, FAR FILEMASK=MSN63ATUF ;Player defaults to DMP.EXE ;Setup for a MONO DAC on port 3BC [Mono DAC] OPTIONS=-p3BC -c6 -q -8 -l FILEMASK=MSN63F ;Modplay setup [Modplay 2.19b] ;Filemask defaults to MOD only. PLAYER=C:\UTILS\MP.COM ;Can specify full path of player! <--- END OF CONFIG FILE ---> ■ DMPC will search the path for ARJ.EXE, LHA.EXE, PKUNZIP.EXE (or UNZIP.EXE), PKZIP.EXE (or ZIP.EXE), LIMIT.EXE, SQZ.EXE, DMP.EXE and DMPC.CFG, if it can't find DMPC.CFG in the path, current directory or the directory where DMPC.EXE was executed from it will take -p42 -c6 (PC SPEAKER!! <--- Yech!) and DMP as default. If ARJ.EXE cannot be found (using the same search technique as for DMPC.CFG), DMPC will not search ARJ files for music files (similarly for LHA, ZIP, LIMIT and SQZ). When a file occurs decompressed and in archives, only the decompressed file is shown in the list of available music. Limitations ■ ┌────────────────────────────────────────────────-─--∙∙··· · ───────────────────┘ ■ If you don't have EMS on your machine (something I would find hard to believe on a 386!), DMPC will crawl when you try to play anything 'cause it will be swapping to disk. ■ You can only use up to 1000 music files in any one directory. ■ DMPC will not work on Hercules displays. ■ The sample preview on PC Speaker sounds lousy, but it always does... ■ I don't think DMPC can handle 16 bit samples. ■ DMPC can lock the machine if there aren't enough DOS stacks allocated in your CONFIG.SYS, so if you're experiencing lockups, set it to STACKS=9,512 and it should fix the problem. ■ Sample playback for SoundBlaster uses a 64k DMA buffer, so make sure you have your memory manager allocating 64k for it's DMA transfers! »» Now stop reading this dumb DOC and go and play some music! *8) «« Thanks to ■ ┌────────────────────────────────────────────────-─--∙∙··· · ──────────────────┘ ∙ Otto Chrons for writing DMP/PMP and sending me information about his AMF format. Ask him about DSMI (what DMP was written with). ∙ Robert Jung for the tech info about ARJ files in UNARJ230.EXE ∙ Thomas Wagner for his PD swapout routine. ∙ Thayne Breetzke for his advice and positive criticism. ∙ Bryan Kilian for helping me get DMPC from just an idea into such a popular program (not to mention helping with the code some of the time!). ∙ Rory Freeman for various helpful routines. ∙ Sand (K. Sunley) for designing a really cool ANSI screen for DMPC. ∙ Mark Adler for sending me the ZIP header format. ∙ Toni Nikkanen for becoming a registered DMPC user... *8) ∙ All the people who have responded so positively (and negatively?) to DMPC! ∙ My friends on IRC for suggesting new features & functions. ∙ Ashton Mills for making this doc more readable! ∙ Daniel Nicholson for giving me ideas on how to implement the ripper. ∙ VangelisTeam's Tracker source... I learnt some things in there! ∙ Jeff Bird & the SoundBlaster Freedom Project (even though I had to do some really weird corrections to the code to get it to work!). ∙ Necros of The Psychic Monks for forcing me to put S3M ripping routines into DMPC and for No Memories II. ∙ Worx (Roger Moe) for helping me fix the bugs in the timer polling routine of the sample previewer. ∙ Nocturnus for finding the format specs for MTM, FAR & ULT for me! To do ■ ┌────────────────────────────────────────────────────-─--∙∙··· · ──────────────┘ - Any other archivers you want supported? - Support other soundcards? Anyone willing to find & send me info on PAS & Gravis Ultra Sound cards? (In C, ASM or Turbo Pascal) - Add support for more formats in the ripper... all I need now are the format specs and I'll add them! - Anyone want me to add FSM sample saving into DMPC? » If you can think of anything else you want to see in future releases, just pop me some email at the address mentioned above. New Versions ■ ┌─────────────────────────────────────────────-─--∙∙··· · ─────────────────────┘ Can always be found at: » ftp.sun.ac.za under: /pub/msdos/audio/local » ftp.uwp.edu under: /pub/incoming/modplayers OR pub/msdos/modplayers » ftp.wustl.edu under; /pub/msdos_uploads/sounds Contact moi at ■ ┌───────────────────────────────────────────-─--∙∙··· · ───────────────────────┘ ∞ email : cslm@cs.ru.ac.za OR g92m3062@hippo.ru.ac.za (These accounts might close anytime now & I don't get to them often) ∞ snail-mail: -> DMPC <- Brad Meier 8 Jasmay PLace Nahoon Valley East London 5241 South Africa ──────────────────────────────────────────────────────────────────────────────